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SYSTEM AND METHOD FOR REPORTING THE ADDITION AND 
DELETION OF TAPI LINE AND PHONE DEVICES IN ABSENCE OF SUCH 

NOTIFICATION FROM A PBX 

RESERVATION OF COPYRIGHT 

A portion of the disclosure of this patent document contains material 
which is subject to copyright protection. The copyright owner has no 
objection to the facsimile reproduction by anyone of the patent document or 
the patent disclosure, as it appears in the Patent and Trademark Office patent 
file or records available to the public, but otherwise reserves all copyright 
rights whatsoever. 

BACKGROUND OF THE INVENTION 
FIELD OF THE INVENTION 

The present invention relates to communications systems and, in 
particular, to a communication system employing a private branch exchange 
(PBX) and a TAPI interface. 

DESCRIPTION OF THE RELATED ART 

The Telephony Application Programming Interface (TAPI) is a high 
level programming interface for Windows™ which supports many types of 
telephony applications associated with conventional analog public telephone 
lines, PBX phone lines, ISDN phone lines, and the like. Thus, TAPI allows a 
communication application to support numerous telephony operations through 
a variety of mediums by making a function call to TAPI which will drive the 
hardware (fax/modem card, DSP card, network switch, and the like) coupled 
thereto. 

The TAPI architecture 100 is illustrated in FIG. 1. As shown, the TAPI 
architecture 100 includes a TAPI implementation 104 interfaced to telephony 
application programs 102. TAPI 104 provides a connection to a TAPI service 
provider, such as a TAPI server 106, which then interfaces to hardware such 
as voices cards 108a, H.323 interfaces 108b, or PBX's 108c. 

The TAPI specification requires that device configuration information 
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be available at the startup of the TAPI service provider. If unsolicited 
addition and deletion events from a telephony device hardware, such as a 
PBX, are not supported (i.e., the hardware does not automatically inform the 
TAPI service provider of updates), the TAPI service provider can only do 
5 configuration change updates at start up. The TAPI service provider does so 
by requesting the static device configuration from the PBX, building the initial 
internal database and reporting all the devices to the TAPI. If changes are 
made on the PBX, the telephony server system administrator would be 
required to shut down the TAPI service provider and restart it again. This has 
10 the disadvantage of disrupting service to all users of the TAPI service 

O provider. Moreover, in such a system, there is no way to shut down a TAPI 

service provider if it is in use. It will be shut down only if every TAPI 

H application using it shuts down. Since several thousand clients can be 

¥= supported, this can provide severe disadvantages in administration. 

% 15 

~,. SUMMARY OF THE INVENTION 

f|j These and other drawbacks in the prior art are overcome in large part 

% by a system and method for client configuration in a TAPI environment 

O according to the present invention. Briefly, the present invention provides a 

20 method whereby a TAPI service provider may request configuration 
information from hardware such as a PBX. Configuration information 
received from the hardware is stored in a list and compared to the existing 
configuration list. Two new lists are then generated: an added list and a 
deleted list. All devices in the deleted list are deleted from the internal 
25 database and deleted messages are sent to the TAPI service provider. All 
new devices are temporarily added to the internal database and addition 
messages are sent to the TAPI service provider. The new device 
configuration list is then saved, and the added devices are marked as 
permanent. 



BRIEF DESCRIPTION OF THE DRAWINGS 

A better understanding of the invention is obtained when the following 
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detailed description is considered in conjunction with the following drawings in 
which: 

FIG. 1 is a diagram representative of the TAPI architecture; 

FIG. 2 is a diagram illustrating a computer system employing a TAPI 
5 system according to an implementation of the present invention; 

FIG. 3 is a block diagram of the computer system of FIG. 2 according 
to an implementation of the present invention; and 

FIG. 4A and FIG. 4B are flowcharts illustrating operation of an 
implementation of the invention. 

10 

DETAILED DESCRIPTION OF THE INVENTION 

FIGS. 2-4 illustrate an improved system and method for a TAPI service 
provider to request and update configuration information from hardware such 
as a PBX. Configuration information received from the hardware is stored in 

1 5 a list and compared to the existing configuration list. Two new lists are then 
generated: an added list and a deleted list. All devices in the deleted list are 
deleted from the internal database and deleted messages are sent to the 
TAPI service provider. All new devices are temporarily added to the internal 
database and addition messages are sent to the TAPI service provider. The 

20 new device configuration list is then saved, and the added devices are 
marked as permanent. 

An exemplary TAPI client 202 is shown in FIG. 2. The TAPI client 202 
may be embodied as a personal computer, including a system unit 1 1 , a 
keyboard 12, a mouse 13, and a display 140. Also shown are one or more 

25 speakers 1 50a, 1 50b, and a microphone 1 601 . The screen 1 60 of the display 
device 14 is used to present a graphical user interface (GUI) and particularly, 
a TAPI client window 3008. The graphical user interface supported by the 
operating system allows the user to employ a point and click method of input, 
i.e., by moving the mouse pointer or cursor (not shown) to an icon 

30 representing a data object at a particular location on the screen 1 60 and 
pressing one or more of the mouse buttons to perform a user command or 
selection. The GUI may be any of the Windows GUIs available from 
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Microsoft Corporation or the Macintosh OS, available from Apple Computer. 

FIG. 3 shows a block diagram of the components of the personal 
computer shown in FIG. 2. The system unit 1 1 includes a system bus or a 
plurality of system buses 21 to which various components are coupled and by 

5 which communication between the various components is accomplished. The 
microprocessor 22 is coupled to the system bus 21 and is supported by the 
read only memory (ROM) 23 and the random access memory (RAM) 24 also 
connected to the system bus 21 . The microprocessor 22 may be embodied 
as any of a variety of microprocessors, including Intel x86, Pentium or 

10 Pentium II or compatible processors. 

The ROM 23 contains among other code the basic input output system 
(BIOS) which controls basic hardware operations such as the interaction of 
the disk drives and the keyboard. The RAM 24 is the main memory into 
which the operating system and applications programs are loaded. The 

1 5 memory management chip 25 is connected to the system bus 21 and controls 
direct memory access operations including passing data between the RAM 24 
and hard disk drive 26 and floppy disk drive 27. A CD ROM drive (or DVD or 
other optical drive) 32 may also be coupled to the system bus 21 and is used 
to store a large amount of data, such as a multimedia program or a large 

20 database. 

Also connected to the system bus 21 are various I/O controllers: The 
keyboard controller 28, the mouse controller 29, the video controller 30, and 
the audio controller 31 . The keyboard controller 28 provides the hardware 
interface for the keyboard; the mouse controller 29 provides the hardware 

25 interface for the mouse 1 3; the video controller 30 is the hardware interface 
for the video display 14; and the audio controller 31 is the hardware interface 
for the speakers 15 and microphone 16. The speakers 150a, b and the 
microphone 1601 allow for audio communication during telephony operation. 
In operation, keyboard strokes are detected by the keyboard controller 28 and 

30 corresponding signals are transmitted to the microprocessor 22; similarly, 
mouse movements and button clicks are detected by the mouse controller 
and provided to the microprocessor 22. Typically, the keyboard controller 28 
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and the mouse controller 29 assert interrupts at the microprocessor 22. In 
response, the microprocessor 22 executes a corresponding interrupt routine, 
as is known. Additionally, an interrupt controller (not shown) may be provided 
to arbitrate among interrupt requests. An I/O controller or network interface 
5 40 enables communication over a network 46, such as a packet network. 

One embodiment of the present invention is as a set of instructions in a 
code module resident in the RAM 24. Until required by the computer system, 
the set of instructions may be stored in another computer memory, such as 
the hard disk 26, on an optical disk for use in the CD ROM drive 32, or a 
1 0 floppy disk for use in the floppy disk drive 27. 

As shown in the figure, the operating system 50, the TAPI application 
52, the TAPI service provider 53, and one or more configuration table objects 
56 are resident in the RAM 24. As is known, the operating system 50 
functions to generate a graphical user interface on the display 14. The TAPI 
1 5 application program 52 performs TAPI functionality, including generation of a 
TAPI client window 3008 (FIG. 2) in the GUI. The TAPI service provider 53 
implements an interface to the hardware, as will be described in greater detail 
below. 

Turning now to FIG. 4A and 4B, a flowchart illustrating operation of an 
20 implementation of the invention is shown. Upon startup, in a step 402, the 
TAPI service provider 53 requests static configuration information from the 
PBX (not shown) or other telephony hardware. Such static configuration 
information can be static line or static phone device information. In the case 
of a line device, the configuration information includes the device ID and the 
25 number of addresses on the line. In the case of a phone device, the 

information includes the device ID. Turning back to FIG. 4A, in a step 404, 
the PBX returns multiple blocks of information of PBX configuration 
information to the TAPI service provider 53. Next, in a step 406, the TAPI 
service provider 53 instantiates and builds a static configuration table object 
30 (C1). 

In normal operation, devices are added or deleted to the PBX without 
notifications being sent to the TAPI service provider 53. Turning now to FIG. 
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4B, in a step 408, the administrator may request the TAPI service provider 53 
check for PBX configuration changes. In a step 410, the TAPI service 
provider 53 requests static information from the PBX. In a step 412, multiple 
blocks of information containing the PBX configuration data arrive at the TAPI 
5 service provider 53. In a step 414, the TAPI service provider 53 instantiates 
and builds a new static configuration table object (C2). This new object 
becomes the current TAPI configuration object. In a step 41 6, the TAPI - 
service provider 53 takes the C2 object as an input and produces two new 
configuration table objects: deleted objects (C3) and added devices (C4). 
10 In a step 41 8, for each device in C3, the TAPI application 52 is notified 

„ that the corresponding line device has been deleted. In a step 420, for each 

£ device in C3, the TAPI application 52 is notified that the corresponding phone 

A device has been deleted. In a step 422, for each device in C4, the TAPI 

if* application 52 is notified that the corresponding line device has been added, 

yj 1 5 Finally, in a step 424, for each device in C4, the TAPI application 52 is 

J 5 notified that the corresponding phone device has been added. 

5 Further details regarding a specific implementation of a system and 

ry 

Q method according to the present invention are shown in the attached 

S{ Appendix. It is noted, however, that the invention is not limited to the specific 

fete? 

O 20 form set forth herein, but includes such alternatives, modifications and 

equivalents _as can reasonably be included within the spirit and scope of the 
appended claims. 
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APPENDIX 



#include "stdafx.h" 
#include <afxmt.h> 
5 #include "tapi.h" 
#include "tspi.h" 
#include "mu_devls . h n 

tinclude "mdb_opti . h" 

10 #include M mdb_tdat.h" 

#include "mdb_siem.h" 

#include »mdb_tobj . h" 

#include "mdb_mgrs . h" 

#include "mdbjndb.h" 



15 



35 



40 



45 



#include M ti_dbapi .h" 
#include "ti_build.h" 



20 #include "su.h 11 

DEFINESOURCEINFO; 

#include 11 su_shdat .h" 
#include "cdb^main.h" 
25 #include "sh_pl_ad.h" 

#include »su_tcorr .h" 

#include "ti_intf.h" 
30 #include "sh_stats.h" 

# include "mu_aclm.h" 
#include "oss_acl.h" 
#include "oss_csta .h" 



#include "ugglobal.h" 
#include "mp_def s . h" 

mapper_db : : mapper_db ( ) t 
: valid (FALSE) , next_device_id ( 0 ) , _ 

line_device_id_base (0) , phone_device_id_base (0) 

{ 

mapper_db_sem = CreateSemaphore ( NULL, 1, 1, MAPPER_DB_SEM ); 
c stats db& stats_db = get_stats_db ( ) ; 



50 memset ( &s tat s_db . admin_s tats j>tr- 

>eng statistics . eng_mapper_db_stats , 
~~ 0 , 

sizeof ( ENG_MAPPER_DB_STATS ) ) ; 

55 

if ( mapper_db_sem 1= NULL ) 

{ 

valid = TRUE; 

60 } 
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mapper_db : : ~mapper_db ( ) 
valid = FALSE; 

CloseHandle { mapper db sem ) ; 

} 



MAPPER_DB_RC 

mapper_db : : do_delete_static_devices ( device_list& 
device_list , 

EVENT INDICATOR indicator ) 

{ 

MAPPER_DB_RC rc = MAPPERJDB_RC_GOOD; 

cnfg_db& cdb = get_cnf g_db ( ) ,* 

CString extension; 

USHORT type; 

ULONG plid; 

ULONG ppid; 

DWORD sem_jrc; 

while ( device__list . get_next_device (extension, &type, &plid, 
&ppid) ) 

{ 

tapi__static_line *line_p = static_line_mgr . f ind ( 

extension ) ; 

tapi__s tat ic_p hone *phone_p = static_jphone_mgr . f ind ( 

extension ) ; 

if ( (line_p ! = NULL) (phone_p 1= NULL) ) 

tapi_open_phone * open_jphone_p = 

static__cast<tapi_open_phone *> (phone_p- 

>child2_p) ; 

if ( open_phonej != NULL ) 

sem_rc = WaitForSingleObj ect ( open_jphone_p - 
>lock / MAPPER_DB_SEM_WAIT ) ; 

if ( sem rc == WAIT OBJECT 0 ) 
{ " 



open_j?hone_p ) ; 
1 , NULL ) ; 



do_delete_open_jphone_device ( 
ReleaseSemaphore ( op en_jphone_p - >lock, 



} 

else 

{ 



rc = MAPPER_DB_RC_FAILED; 

CString error; 
error. Format ( 

T( n mapper_db: :do_delete_static_devices () . Could not delete phone,") 

* ' su log message ( 0 , 

_ ~~ SU_DEBUG, 

SU TRACE NONE, 

- 0, 

L" " , 

SOURCENAME , 

LINE , 

NULL, 

(LPCTSTR) error ) ; 

} 

tapi_open_line * open_line_p = 

static_cast<tapi_open_line *> (line_p- 

>child2_p) ; 

if ( open_line_p 1= NULL ) 
{ 

sem_rc = WaitForSingleOb j ect ( open_line_p- 
>lock / MAP PER_DB_S EM_WAI T ) ; 

if ( sem_rc == WAIT__OB JECT_0 ) 
{ 



open_line_p ) ; 
1, NULL ) ; 



} 

else 

{ 



do_delete_open_line_device ( 

Re lease Semaphore ( open_line_p- >lock, 

rc = MAPPER_DB_RC_FAILED; 



CString error; 
error. Format ( 

T ( n mapper_db: :do_delete_static_devices () . Could not delete line.") 

^' su log message ( 0; 

- ~ SU_DEBUG, 

SU_TRACE_NONE , 

L" 

SOURCENAME , _ 

LINE , 

0, 

0, 

NULL, 



(LPCTSTR) error ) ; 
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if ( indicator == EVENT INDICATOR SEND EVENT ) 
c_stats_db& stats_db = get_stats_db ( ) ; 



tapi_interf ace& ti = get_tapi_interf ace ( ) ; 



if ( phone_p ! = NULL ) 



SEND_TO_TAPI_RC t_rc = 

ti . send_j?hone_remove ( phone jp- 

>devid + phone_device_id_base , 0 ) ; 

if ( t rc ]= SEND TO TAPI RC GOOD ) 
{ " - - - 

CString error; 

error . Format ( 

_T ( "mapper_db : :do_delete_static_devices () . Problem sending event: 
phone remove . " ) ) ; 

su_log__message ( 0, 

SU_DEBUG, 
SU_TRACE_NONE , 

0 

L" " , 

SOURCENAME , 

LINE , 

t_rc , 

0 

NULL, 

(LPCTSTR) error ) ; 

} 



if ( cdb . debug_tracing_on ( 

DBG MAPPER DB BIT ) ) 

_ ~ { 

CString error; 
error . Format ( 

_T ( "mapper_db : : do_delete_static_devices ( ) . Sent event: phone remove 
) ; 

su_log_message ( 0, 

SU_DEBUG , 
SU_TRACE_NONE , 

0 

L nn , 

SOURCENAME , 
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LINE , 

t_rc, 

NULL, 

(LPCTSTR) error ); 



0, 



} 



stats_db . admin_stats_ptr-> 

eng statistics . eng_mapper_db_stats . 

~~ phones_deleted++; 

} 

if ( line_p != NULL ) 
{ 

SEND_TO_TAPI_RC t_rc = 

t i . s end_l i ne_r emove ( line _p- 

>devid + line_device_id_base, 0 ) ; 

if ( t_rc != SEND_TO_TAPI_RC_GOOD ) 

{ 

CSt ring error; 
error . Format ( 

_T("mapper_db: :do_delete_static_devices () . Problem sending event: 

su_log_message ( 0, 



line remove . " ) ) ; 



SU_DEBUG, 
SU_TRACE_NONE , 

L" 

SOURCENAME , 

LINE , 

t_rc , 

NULL, 

(LPCTSTR) error ) ; 
DBG MAPPER DB BIT ) ) 



} 

if ( cdb .debug_tracing_on ( 

{ 



CString error; 
error. Format ( 

_T("mapper__db: :do_delete_static_devices () . Sent event: line remove" 
) ; 

su_log_message ( 0, 

SU DEBUG, 
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SU TRACE NONE, 



0, 



SOURCENAME , 

LINE , 

t_rc , 

NULL, 

(LPCTSTR) error ) ; 



} 



0, 



stats_db . admin_stats _ptr-> 
eng_statistics . eng_mapper_db_stats . 



lines deleted++; 



} 



} 



if { phone_p I= NULL ) 

if ( cdb.debug_tracing_on ( 
DBG_MAPPER_DB_OBJ_BIT ) ) 

CString error; 
error . Format ( 
T ( "mapper db : : do_delete__static_devices ( ) . \n\ 

Deleting static phone: Ptr - %lx, Object ID = %ld, Device ID = 
%d, Device base = %d # Quick key = %ld, Extension = %s, Monitor status 
= %d") , 

phone_jp , 

phone_jp->obj ect_id, 
phone_p - >devid , 
phone_device__id_base , 

phone _jp - >quick_key , 
phone_j? - >primary_extension , 
phone j) - >monitor_on ) ; 



su__log_message 



( 



0, 



SU DEBUG, 



SU TRACE NONE , 



0 , 
L" " 



SOURCENAME, 



(LPCTSTR) error ) ; 



LINE_ 

0, 

NULL, 



staticjphone^mgr . remove__f rom_in__use_list 

phone_p) ; 
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phone_p- >parent_p = NULL; 
phone_p->child2_p = NULL; 



static_phone_mgr , add_to_f ree_list ( phone_p 



if ( line p ! = NULL 
{ 



if ( cdb . debug__tracing_on ( 
DBG MAPPER DB OBJ BIT ) ) 



tapi_static_address * address_p = 

static__cast<tapi_static_address 

*> 

<line__p->childl_p ) ; 

CString error; 

error. Format ( 
_T ( "mapper_db : : do_delete_static_devices ( ) . \n\ 

Deleting static line: Ptr = %lx, Object ID = %ld, Device ID = %d, 
Device base = %d, Quick key = %ld, Extension = %s, Monitor status = 
%d\n\ 

With static address: Ptr = %lx, Object ID = %ld, Device ID = 
%d, Quick key = %ld, Extension = %s"), 

line_j> , 

line_p->object_id, 
line_p->devid / 
line_device_id_base , 

lineup ->quick__key, 
line_p - >primary_ext ens ion , 
1 inej) - >moni t or_on , 
address_p , 

address__p->obj ect_id, 
address_p- >devid, 
address_jp- >quick_key , 
address_p->primary_extension ) ; 



s u_ 1 o g_m e s s a g e 



( 



0, 



SU DEBUG, 



SU TRACE NONE, 



SOURCENAME , 



(LPCTSTR) error ) ; 



0, 
L" 1 



LINE_ 

0, 
0, 

NULL , 



line_p ) ; 



static_line_mgr . remove^f rom_in_use_list { 



line_p- >parent_p = NULL; 
line_p->child2_p = NULL; 
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} 

else 

{ 



static_line_mgr . add_to_f ree_list ( linejp ); 



rc = MAPPER_DB_RC_FAILED; 



CSt ring error; 
error . Format ( 

_T( n mapper_db: :do_delete_static_devices () . Bad pointer(s), line = 
%lx, phone = %lx. ") , 

line__jp, phone_p ) ; 

su log message ( 0, 

~ ~ SUJDEBUG, 

SU_TRACE_NONE , 
0, 

L " " , 

SOURCENAME , 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) ; 

} 

} 

return ( rc ) ; 



MAPPER__DB_RC 

mapper_db: : do_add_static_devices ( device_list& 
device__list , 

E VENT_IND I CATOR indicator ) 
^ MAPPER_DB_RC rc = MAPPER_DB_RC_GOOD ; 

cnfg__db& cdb = get_cnf g__db ( ) ; 

CString extension; 
USHORT type; 
ULONG plid; 
ULONG ppid; 

while ( device_list . get_next_device (extension, ktype, kplid, 
&ppid) ^) 

tapi_static_line *linej> = 
static_line_mgr . remove_f rom_f ree_list () ; 

tapi_static _jphone *phone_p = 
static__phone_mgr . remove_f rom_f ree__list () ; 



if ( (line__p 1= NULL) (phonej) != NULL) ) 

{ 
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■artsy 



15 



35 



40 



60 



line_p- >parent_p = phone_p ; 
phone_p - >parent_p = line_p; 



line_p->devid = next_device__id; 
phone_p->devid = next_device_id; 



if ( indicator == EVENT_INDICATOR_SEND_EVENT ) 

10 { 

line_p->devid |= TEMP BIT; 

phone_p->devid J= TEMP_BIT; 

} 



tapi_static_address *address__p = line_p- 
>get_static_address () ; 



wcscpy ( line_p->prijnaary_extension, 
20 (LPCTSTR) extension ) ; 

wcscpy ( phone_p->primary_extension, 

(LPCTSTR) extension ); 
wcscpy ( address _p - >primary_extens ion , 

(LPCTSTR) extension ); 

25 

line_jp->quick_key = _wtol ( 
(LPCTSTR) (extension. Right (7) ) ) ; 

phone_p->quick_key = line_p~>quick_key; 
30 address_jp->quick_key = lineup- > qui ckjcey; 



lineaddresscaps_data& address_caps = 

address_p->get_lineaddresscaps () ; 

address_caps . ts_lineaddresscaps . dwLineDevicelD 
line_jp- >devid + line_device_id_base ; 

address_caps . ts_address = extension; 



if ( type == anate ) 

{ 

45 address caps . ts_lineaddresscaps . dwAddrCap Flags &= 

~ L I NE ADDRCAP F L AG S_OR I GO F FHOO K ; 

} 

50 linedevcaps_data& line_caps = line_p- 

>get_linedevcaps () ; 

line_caps . ts_linedevcaps . dwPermanentLinelD = plid 
55 line_caps . ts_line_name = extension; 



phonecaps_data& phone_caps = phone _p- 

>get jhonecaps () ; 

phone_caps . tsj)honecaps . dwPermanent Phone ID = ppid 
phone_caps . ts_phone_name = extension; 



65 switch ( type 

{ 
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break; 



Station"); break; 



Mail") ; break; 



case anate : phone_caps . ts_phone_inf o = 

_T ("Analog Device"); 



case opslma: 

case opstl: phone_caps . t s_phone__inf o = 

T("Off Premise 



case extvcml : phone_caps . ts _phone_inf o = 

T( "External Voice 



case kysetjr: 

case kysetdy: phone_caps . ts _jphone_inf o = 

_T( "Keyset") ; break; 

case phantom: phone_caps . ts_j>hone_info - 

T("Phantom n ) ; break; 



break; 



case rp!20 : 

case rpl20D: phone_caps . ts_phone_inf o = 

_T ("Rolmphone 120"); 



case rp240: 
case rp240B: 
case rp240D: 
case rp240E: 

case rp240ED: phone_caps . t s_phone_inf o = 

T(" Rolmphone 120"); 



break; 



case rp312 : 

case rp312L: phone_caps . ts_phone_inf o = 

_T ("Rolmphone 312"); 

break; 

case rp400: 

case rp4 0 0D: phone_caps . ts j5hone_inf o = 

_T ( "Rolmphone 400"); 

break; 



case rp612 : 

case rp612D: 

case rp612DK: 
case rp612K: 
case rp612L: 
case rp612LD : 
case rp612LK: 
case rp612LDK: 
case rp612S: 
case rp612SD: 
case rp612SK: 
case rp612SL: 
case rp612SDK: 
case rp612SLD: 

case rp612SLK: 

case rp612SLDK: phone_caps . ts_j>hone_inf o = 

__T( "Rolmphone 612"); 

break; 

case rp624 : 
case rp624D: 
case rp624DK: 
case rp624K: 
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case rp624L: 
case rp624LD: 
case rp624LK: 
case rp624LDK: 
case rp624S: 
case rp624SD: 
case rp624SK: 
case rp624SL: 
case rp624SDK: 
case rp624SLD: 

case rp624SLK: 

case rp624SLDK: phone_caps . ts_phone_inf o = 

_T ("Ro Imp hone 624"); 

break; 

case rp4327 : 

case rp4327T: phone__caps . ts_phone_inf o = 

_T ( "Rolmphone 4327"); 

break; 

case nil200SL: phone_caps . ts_phone_inf o = 

_T ( " Optiset-NI 

Phone" ) ; break; 

case optie3 : phone_caps . ts_phone__inf o = 

_T("Optiset Entry 

Phone") ; break; 

case optie8: phone_caps . ts _jphone__inf o = 

_T ("Optiset Basic 

Phone") ; break ; 

case optieSL: phone_caps . ts_phone_inf o = 

_T("Optiset Standard 

Phone" ) ; break; 

case optielL: phone_caps . ts_jphone_inf o = 

_T("Optiset Advanced 

Phone") ; break; 

case optielSL: phone_caps . ts_phone_inf o = 

_T("Optiset Advanced 

Plus Phone"); break; 

case rmdcm: 

case adcm: phone_ caps . t s_phone_inf o = 

_T("Data Comm 

Module") ; break; 

case set211: phone_caps . ts_phone_inf o = 

_T("Set 211 Phone"); 

break; 

case set2 60: phoneme aps . ts_phone_inf o = 

_T("Set 2 60 Phone"); 

break; 

case set4 00: phone_caps . ts_phone_inf o - 

__T("Set 4 00 Phone"); 

break; 

case setSOO: phone_caps . ts _jphone_inf o = 

__T("Set 500 Phone"); 

break; 

case set600: phone_caps . t s_jphone_inf o = 



break; 



break; 



= T( "Generic") ; 



DBG MAPPER DB BIT ) ) 
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T("Set 600 Phone") ; 



case set700: phone_caps . ts_phone_inf o - 

T("Set 700 Phone") ; 



case other: phone_caps . ts__phone_inf o = 

_T ( "Generic" ) ; break; 

default : 

phone_caps . ts_phone__inf o 

if ( cdb . debug_tracing__on ( 



CString error; 
error . Format ( 

_T { "mapper_db : :do__add_static_devices () . Unexpected device type = 
%d»), 

type ) 

su_log_message ( 0, 



SU_DEBUG , 
SU_TRACE_NONE / 

L" 

SOURCENAME, 
LINE , 

NULL, 

(LPCTSTR) error 



0, 



0, 



) 



} 

break; 

} 

static_line_mgr . add_to_in_use_list ( line_p ); 
static_phone_mgr . add__to_in_use_list ( phone j ); 

if ( cdb.debug_tracing_on ( DBG_MAPPER_DB_OBJ_BlT ) 
{ 



CString error; 

error. Format ( 
_T ( "mapper_db : : do_add_s tat ic_devices ( ) . \n\ 

Adding static line: Ptr - %lx, Object ID = %ld, Device ID = %d, 
Device base - %d, Quick key = %ld, Extension = %s, Monitor status = 
%d\n\ 

With static address: Ptr = %lx, Object ID = %ld, Device ID = 
%d, Quick key = %ld, Extension = %s\n\ 
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With static phone: Ptr = %lx, Object ID = %ld, Device ID = %d, 
Device base = %d, Quick key = %ld, Extension = %s, Monitor status = 
%d") , 

line _j? , 

line jp->object_id, 
line_p->devid, 
line_device_id_base, 

1 ine_p - >qui ck_key , 
line_jp->primary_extension, 
line_p - >monitor_on , 
address_jp , 

address_p->obj ect_id, 

addr e s s_p - >devi d , 

addr e s s_jp - > qu i c k_key , 

addres s_p - >pr imary_extens ion , 

phone_p , 

phone_jp- >ob j ect_id, 
phone_p - > devi d , 
phone_device__id__base 

phone__p - >qui ck_key , 
phone_p - >p r imary__ex t ens i on , 
phone_p->monitor__on ) ; 

su log message ( 0, 

~ ~ SU_DEBUG, 

SU_TRACE_NONE , 
0, 

L " " , 

SOURCENAME , 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error 



) ; 



>devid, 0 ) ; 



} 

if ( indicator == EVENT_INDICATOR_SEND_EVENT ) 
{ 

cnfg_db& cdb = get_cnf g_db ( ) ; 

HPROVIDER ph = cdb . get_provider_handle ( ) ; 

tapi_interf ace& ti = get_tapi_interf ace ( ) ; 

SEND_TO_TAPI_RC t_rc = 

ti . send_line_create ( ph, line_p- 



if ( t rc != SEND_TO_TAPI_RC_GOOD ) 

{ 

CStrxng error; 
error - Format ( 

_T("mapper_db: : do_add_s tat ic_de vices () . Problem sending event: line 

create . " ) ) ; , A 

su log message ( 0, 

" ~ SUJDEBUG, 

SU TRACE NONE, 

- — 0 , 

L" " , 



SOURCENAME, 
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LINE , 

t_rc , 

NULL, 

(LPCTSTR) error ) ; ^ 

if ( cdb.debug_tracing_on ( DBG_MAPPER_DB_BIT 

i 

CSt ring error; 
error . Format ( 

_T("mapper_db: :do_add_static_devices () . Sent event: line create") ); 

su_log_message ( 0, 

SU DEBUG, 



SU TRACE NONE, 



SOURCENAME, 



0, 
L ii t t 



LINE_ 

t_rc, 

NULL f 



(LPCTSTR) error ) ; ^ 

t rc = ti . send_jphone_create ( ph, phone_p- 

>devid, 0 ) ; 

if ( t rc 1= SEND__TO_TAPI_RC_GOOD ) 
{ 

CString error; 
error . Format ( 

_T("mapper_db: : do_add_static_devices () . Problem sending event: phone 

create . " ) ) ; . 

su log message ( 0, 

" ~ SU_DEBUG, 

SU TRACE NONE , 



SOURCENAME , 



(LPCTSTR) error ) ; 



) ) 



LINE_ 

t_rc, 
NULL, 



} 

if ( cdb.debug_tracing_on ( DBG_MAPPER_DB_BIT 

{ 



CString error; 
error . Format ( 

_T("mapper__db: :do_add_static_devices () . Sent event: phone create") ); 
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15 



su_log_message ( 0, 

SUJDEBUG, 

SU TRACE NONE , 



10 SOURCENAME, 



0, 



LINE_ 

t_rc , 

NULL, . 



(LPCTSTR) error ) ; 



} 

20 c_stats__db& stats*_db = get_st'ats_db ( ) ; 

stats_db . admin_stats_ptr-> 

eng__statistics . eng_mapper_db_stats . 
25 outstanding_line_creates++; 



30 



stats_db . admin_stats_jptr- > 

eng_statistics . eng_mapper_db_stats . 
outstanding__phone_creates++; 



++next__dev i c e_id ; 



ry { 

rc = MAPPER_DBJRC_FAILED; 

Q 40 if ( line__p != NULL ) 

a { 



static_line__mgr . add_to_f ree_list ( line _p 

} 



45 if ( phone_p != NULL ) 



) ; 



50 



static_phone_mgr . add_to_free_list ( phone _j> 

} 



CSt ring error; 
error. Format ( 

_T("mapper_db: :do_add_static_devices () . Could not allocate, line = 

%lx, phone- %lx. " ) , 
55 lineup, phone_p ) ; 

su log message ( 0, 

~ ~~ SU__DEBUG, 

SU_TRACE_NONE , 

60 L""/ 

SOURCENAME , 

LINE , 

0, 

65 NULL, 

(LPCTSTR) error ) ; 
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break; 



return ( rc ) ; 



MAPPER_DB_RC 

mapper_db :: get __s tat ic_de vice ( DWORD 
device_id, 

tapi_static_line **line_pp ) const 

MAPPER_jDB_RC rc = MAPPER_DB_RC_GOOD ; 



if ( line__pp 1= NULL ) 



DWORD sem_rc - 

WaitForSingleObject ( mapper_db_sem, 
MAPPER DB SEM_WAIT ) / 



if ( sem rc == WAIT OBJECT 0 ) 
{ " 

*line__pp = 

static_line_mgr . f ind ( device_id - 

line_device_id_base ) ; 



if { *line_pp != NULL ) 



cnfg_db& cdb = get_cnf g_db ( ) ; 



if ( cdb , debug_tracing_on ( 

DBG MAPPER DB OBJ BIT ) ) 
_ - - { 

tapi__static_address * address_p = 

stat ic_cast < tap i_s tat ic_address 

*> 

( (*line_j?p) ->childl_p ) ; 

CString error; 
error. Format ( 

__T { "mapper_db :: get_s tat ic_device ( line) . Given device ID = %ld\n\ 

Found static line: Ptr = %lx, Object ID = %ld, Device ID = %d, 
Device base = %d, Quick key = %ld, Extension - %s, Monitor status = 
%d\n\ 
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With static address: Ptr - %lx, Object ID = %ld, Device ID = 
%d, Quick key = %ld, Extension = %s") , 

device_id, 
*line_pp , 

(*line_pp) ->object_id, 
(*line_pp) ->devid, 
line_device_id_base , 

(*linejpp) ->quick_key, 
(*line_pp) - >primary_extension / 
(*line_pp) ->monitor_on / 
address_p, 

addres s_p - >ob j ec t_id , 

address_j?->devid, 

addre s s_p - >quick_key , 

address _p->primary_extension ) 



su_log_message 



C 



0, 



SU DEBUG , 



SU_TRACE_NONE , 



0, 
L" 



SOURCENAME , 



LINE 

NULL, 



(LPCTSTR) error ) ; 

} 

else 

{ 



rc - MAPPER__DB_RC_FAILED ; 



CString error ; 
error. Format ( 

_T ( "mapper_db : :get_s tat ic_device ( line) . Could not find device, ID = 
%ld " ) , 



) ; 



su_log_message 



device_id ) ; 
( 0, 

SU_DEBUG , 
SU_TRACE_NONE , 
0, 

L" " , 

SOURCENAME, 

LINE , 

0 , 

o, 

NULL , 

(LPCTSTR) error 



} 



} 

else 

{ 



ReleaseSemaphore ( mapper_db_sem, 1, NULL ) ; 



rc = MAPPER_DB_RC_TIMEOUT; 



else 
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rc = MAPPER_DB_RC__BAD_PARAM; 

5 CString error; 

error. Format ( _T ( "mapper_db : :get_static_device (line) 
Bad param, device ptr = %lx "), 

line_jpp ) ; 
su_log_message { 0, 
1 0 SU_DEBUG , 

SU_TRACE_NONE , 
0, 

L" n , 

SOURCENAME , 

15 LINE , 

0, 
0, 

NULL, 

(LPCTSTR) error ) ; 

20 } 



25 



} 



return ( rc ) ; 



r "* ! 30 MAPPER_DBJRC 

|ij mapper_db: :get_static_device ( DWORD 

■£ device id, 



35 { 



tapi_static_phone **phone_pp ) const 
MAPPER DB RC rc = MAPPER DB RC GOOD ; 



if C phone pp i= NULL ) 

40 { 



45 



DWORD sem__rc = 

WaitForSingleObject ( mapper_db_sem, 
MAPPER DB SEM WAIT ) ; 



if ( sem rc « WAIT_0B JECT_0 ) 
{ 



50 *phone_pp = 

static^ phone_mgr . f ind ( device_id 

phone_device_id_base ) ; 

55 if ( *phone_pp != NULL ) 

{ 



cnfg_db& cdb = get_cnf g_db C ) ; 



60 



if ( cdb . debug__tracing_on ( 
DBGJVIAPPER_DB_OBJ_BIT ) ) 

CString error; 

65 error . Format ( 

_T ( n mapper_db: : get_static_device (phone) . Given device ID = %ld\n\ 
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Found static phone: Ptr = %lx, Object ID = %ld, Device ID = %d, 
Device base = %d, Quick key = %ld, Extension - %s, Monitor status - 

%dn) ' ^ • 

device_id, 

*phone_pp , 

(*phone_pp) ->object_id / 
(*phone_pp) ->devid, 
phone_device_id_base , 

( *phone_pp ) - > qui ck_key , 
(*phone_pp) ->primary_extension, 
(*phone_j)p) ->monitor_on ) ; 



su_log_message 



( 



0, 



SU DEBUG, 



SU TRACE NONE , 



0, 
L" " 



SOURCENAME , 



LINE_ 

0, 

NULL , 



(LPCTSTR) error ) 



} 



else 

{ 



rc = MAP PER_JDB_RC_F AILED ; 



CString error; 
error. Format ( 

__T("mapper_db: :get_static_device (phone) . Could not find device, ID = 
%ld ") , 



) ; 



su_log__message ( 



device_id ) ; 
0, 

SU_DEBUG , 
SU_TRACE_NONE , 

L" 

SOURCENAME , 

LINE , 

0, 
0, 

NULL, 

(LPCTSTR) error 



} 



} 

else 

{ 



ReleaseSemaphore ( mapper_db_sem, 1, NULL ) ,- 



rc = MAPPER_DB_RC_TTMEOUT; 



} 

else 

{ 



rc = MAPPER DB RC _BAD_P ARAM ; 
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III 



%Sttf 



CString error; 

error . Format ( _T ( T, mapper_db :: get_static_device (phone 
Bad param, device ptr = %lx ") , 

phone__pp ) ; 
5 su_log_message ( 0/ 

SU_DEBUG , 

SUJTRACEJSTONE, 

0, 

L" 

10 SOURCENAME , 

LINE , 

0, 

o, 

NULL; 

15 (LPCTSTR) error ); 



20 } 



Ul 25 



30 



fij 35 



return ( rc ) ; 



MAPPER_DB_RC mapper^db :: cr eat e_de vices ( device__list& dev_list 
MAPPER DB RC rc = MAPPER DB RC GOOD; 



cnfg_db& cdb = get_cnf g_db ( ) ; 



40 if ( cdb. debug tracing on ( DBG MAPPER DB BIT ) ) 

{ " " ~ 

CString error; 

error. Format ( _T("mapper_db:create_devices () ") ); 
45 su log_message { 0, 

SU__DEBUG, 
SUJTRACE JSTONE , 
0, 

L" " , 

50 SOURCENAME , 

LINE , 

0, 
0, 

NULL, 

55 (LPCTSTR) error ) ; 



if ( dev list .validate () == TRUE ) 

60 { 

DWORD sem_rc = 

WaitForSingleObj ect ( mapper_db_sem, 
MAPPER DB SEM WAIT ) ; 

65 - - - 
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if ( sem rc == WAIT_OBJECT_0 ) 

{ 

device_list devices; 
devices . init ( ) ; 



tapi_static_line *line_jp = 
static_line_mgr . get_f irst ( ) ; 

while ( line_p != NULL ) 

{ 

devices . add_dev ice ( line_p- 
>primary_ex tens ion, 0, 0 ); 



line_p = line_p->get_next () 



do_delete_static_devices ( devices , 
EVENT_INDICATOR_NONE ) ; 

next device id = 0 ; 



do_add_static_devices ( dev_list, 
EVENT_INDICATOR_NONE ) ; 

c_stats_db& stats_db = get_stats__db ( ) ; 

s tat s_db . admin_s tat s_pt r- > 

eng_statistics . eng_mapper_db_stats - 
ava i 1_1 i ne s_f r om_pbx = 

static_line__mgr . get_in_use_count () ; 

stats_db . admin_stats__ptr-> 

eng__statistics . eng_mapper_db_stats . 
avail_phones_f rom_j>bx = 

staticj)hone_mgr. get_in_use__count () 

stats_db . admin_stats_ptr-> 

t sp_s t a t s . 1 i ne_dev_max = 

static_line_mgr . get_in__use_count () ; 

stats_db . admin_stats _jptr- > 

tsp_stats . phone_dev_max = 

static j)hone_mgr . get_in_use_count () ; 

ReleaseSemaphore ( mapper_db_sem, 1, NULL 

} 

else 

{ 



} 

else 

{ 



rc = MAPPER_DB_RC_TIMEOUT; 

} 



rc = MAPPER DB RC BAD PARAM; 
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CString error; 

error. Format ( _T ( M mapper_db : : create_devices ( ) . Invai 

device Isit . ") ) ; 

su log message ( 0, 

~~ ™ SU_JDEBUG , 

SU_TRACE_NONE , 
0, 

L" " , 

SOURCENAME , 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) ; 



return ( rc ) ; 



MAPPER DB RC . . n ■ . ^ 

mapper_db: :update_devices ( device_list& new_device_list ) 

^ MAPPER_DB_RC rc = MAPPER_DB_RC_GOOD ; 

cnfg_db& cdb = get_cnf g_db ( ) ; 

if { cdb.debug_tracing_on { DBG_MAPPER_DB_BIT ) ) 

{ 

CStrxng error; t 

error .Format ( _T ( "mapper_db : update_devices ( ) " J J; 



su_log_message ( 0, 



SU_DEBUG, 
SU_TRACE_NONE , 
0, 

L" ", 

SOURCENAME , 

LINE , 

0, 

o, 

NULL , 

(LPCTSTR) error ) ; 



} 



device_list original_device_list ; 
cdb.get_device__list ( original_device_list ) ; 

device_list added_device_list ; 
device_list deleted_device_list ; 

added_device_list . init ( ) ; 
deleted_device_list . init () ; 

original_device_list . create_dif f erences ( new_device_list 
added device list, 
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deleted_device_list ) ; 

if ( (added_device_list .validate {) ==TRUE) || 

(deleted_device_list .validate () == TRUE) ) 

{ 

DWORD sem_rc = 

WaitForSingleObject ( mapper_db__sem, 

MAP P E R_D B__S EM_WAI T ) ; 

if ( sem_rc == WAIT_OBJECT_0 ) 

^ rc = do_add_static_devices ( added_device_list , 

EVENT IND I C ATOR_S END_E VENT ) ; 

~~ if ( rc == MAPPER_DB_RO_GOOD ) 

{ 

rc = do_delete_static_devices ( 

deleted_device_list , 

EVENT__IND I CATOR_S END_E VENT ) ; 

c_stats_db& stats_db = get_stats_db ( ) ; 

stats_db . admin_stats_ptr-> 

eng_statistics . eng_mapper_db_s tats . 
avail_lines_from_jpbx = 

static_line_mgr . get_in_use_count () ; 

stats_db . admin_stats_j>tr- > 

eng_statistics . eng_mapper_db_stats . 
avail_phones_f rom__pbx = 

stat ic_ phone_mgr . get_in_use_count ( ) ; 

stats_db . admin_stats_ptr- > 

tsp_stats . line_dev_max = 

static_line_mgr . get_in_use_count () ; 

stats_db . admin_s tat s__ptr- > 

tsp_stats . phone_dev_max = 

static_phone_mgr . get_in_use_count () ; 

if ( rc != MAPPER_DB_RC_GOOD ) 
{ 

CString error; 
error. Format ( 

T ( "mapper_db : : update_devices () . Error delete devices.") ); 
~~ su__log__message ( 0, 



SU DEBUG , 



SU_TRACE__NONE , 



SOURCENAME , 



LINE_ 

rc, 

NULL , 



(LPCTSTR) error ) ; 
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} 

} 

else 

{ 

CString error; 
error . Format ( 

_T ("mapper_db: : update_devices () . Error deleting devices.") ); 

su_log_message ( 0, 



) ; 



SU_DEBUG i 
SU_TRACE_NONE , 
0, 

L" " , 

SOURCENAME, 

LINE , 

0, 

NULL, 

(LPCTSTR) error 



} 

else 

{ 



} 

ReleaseSemaphore ( mapper_db_sem, 1, NULL ) ; 
rc = MAPPER_DB_RC_TIMEOUT ; 



return ( rc ) ; 

} 



MAPPER DB RC , 

Sapper_db: :make_line_permanent ( DWORD temp_id, DWORD device_id 

) 

MAPPERJDB_RC rc = MAPPER_DB_RC_GOOD ; 
cnfg_db& cdb = get_cnf g_db ( ) ; 

if { cdb.debug_tracing_on ( DBG_MAPPER_DB_BIT ) ) 

{ 

CString error; 

error. Format ( _T ( "mapper_db :make_line_permanent ( ) . Temp 
id = %ld, device Id = %ld"), 

temp__id, device_id ) ; 

su log message ( 0, 

~ ~~ SU__DEBUG, 

SUJTRACEJtfONE , 

L" ", 

SOURCENAME , 
LINE 
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0, 

o, 

NULL, 

(LPCTSTR) error ) ; 

} 

tapi_static_JLine *line_j> = s tat ic_l ine_mgr . find ( temp_id ); 

if ( line_p l = NULL ) 

{ 

static_line_mgr .removej rom_in_use__list ( line_p ); 

line__p->devid = device_id - line_device_id_base ; 
static_line_mgr . add_to_in_use_list ( line_p ); 

c_stats_db& stats_db = get_stats_db ( ) ; 

stats_db . admin_s tat s_ptr- > 

eng_statistics . eng_mapper_db_stats . 
outstanding_line_creates-- ; 

stats_db . admin_stats_ptr-> 

eng_statistics . eng_mapper_db_stats . 
1 ines_created++ ; 

stats_db . admin_stats_ptr-> 

eng_statistics . eng_mapper_db_stats . 
avail_lines_f rom_pbx = 

static_line_mgr . get_in__use_count () ; 

stat s_db . admin_stats_jptr- > 

tsp_stats . line_dev_max = 

static_line_mgr . get_in_use_count 0 ; 

if ( cdb.debug_tracing_on ( DBG_MAPPER_DB_OB J_BIT ) ) 

^ tapi_static_address * addressjp = 

static_cast<tapi__static_address *> 
(line_p->childl_p ) ; 

CString error; 
error . Format ( 
"mapper db::make line permanent {) . \n\ 

Static~line: Ptr" - %lx, Object ID = %ld, Device ID = %d, Device 
e = %d Quick key = %ld, Extension = %s, Monitor status = <d\n\ 
With static address: Ptr = %lx # Object ID = %ld, Device ID = 
Quick key = %ld, Extension ~ %s"), 

line_p , 

line_p - >ob j ect_id , 
line_p->devid, 
line_device_id_base , 

1 ine__p - >quick_key , 
line_p- >primary__extension, 
1 ine _p - >moni tor_on , 
address_p, 
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address__p - >ob j ec t_id , 
address_p->devid, 
addr e s s _p - >qu i c k_key , 
address_p->primary_extension ) ; 

su log message ( 0/ 

~ SU_DEBUG, 

SU__TRACE_NONE , 

0; 

L " " , 

SOURCENAME, 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) 



} 

else 

{ 



rc = MAPPER_DB__RC_FAILED; 



CString error; 

error Format ( _T ( "mapper_db : :make_line_permanent ( ) 
Could find temporary line, temp ID = %ld, TAPI id = *ld-"), 

temp__id, device_id ) ; 

su log message ( 0, 

- SUJ3EBUG, 

SU_TRACE_NONE , 

0, 

L" 

SOURCENAME , 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) ; 

} 

return ( rc ) ; 

} 



MAPPER DB RC . ^ ^ T7 _^_ 

mapper_db: :make_phone_permanent ( DWORD temp_id, DWORD 

device_id ) 

^ MAPPERJDB_RC rc = MAPPER__DB_RC_GOOD ; 

cnfg_db& cdb = get_cnf g_db ( ) ; 

if ( cdb.debug_tracing_on ( DBG_MAPPER_DB_BIT ) ) 

{ 

CString error; 

error . Format ( _T ( "mapper_db : make__phone_permanent { ) 
id = %ld, device Id = %ld n ), 

temp_id, device_id ) ; 

su log message ( 0, 

- SU DEBUG; 
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SU_TRACE_NONE , 
0, 

L" " , 

SOURCENAME , 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) ; 

} 

tapi_static_phone *phone_p = s tat ic_phone_mgr . find ( temp_id ) ; 

if ( phone jp != NULL ) 
{ 

static__phone_mgr . remove_f rom_in_Mse_list ( phone_p ); 

phone_p->devid = device__id - phone_device__id_base ; 
static_j>hone_mgr . add_to_in_use_list ( phone_p ); 

c_stats_db&: stats_db = get_stats__db { ) ; 

stats_db . admin_stat s j)tr- > 

eng_statistics . eng_mapper_db_stat s . 
outstanding_phone_creates - - ; 

stat s_db. admin_s tats jptr-> 

eng_statistics . eng_mapper_db_stats . 
phones_created++ ; 

s tats__db . admin_stats_ptr- > 

eng_statistics . eng_mapper_db_stats . 
avail_phones_f rom_pbx = 

staticj?hone_mgr . get_in_use_count () ; 

stats_db . admin_stats__ptr-> 

tsp_stats . phone_dev_max = 

static__phone_mgr . get_in__use_count () ; 

if ( cdb.debug_tracing_on ( DBG_MAPPER_DB_OBJ_BIT ) ) 
{ 

CString error; 
error . Format ( 
"mapper db : : make_phone permanent ( ) . \n\ 
Deleting static phone: Ptr = %lx, Object ID = %ld, Device ID = 
Device base = %d, Quick key = %ld # Extension = %s, Monitor status 
d") , 

phone_jp , 

phone_jp->obj ect_id, 
phone__p - >devid , 
phone_device_id__base , 

^ phone_p->quick_key, 
phone__p - >primary_ext ens ion , 
phone_p->monitor_on ) ; 
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SU_DEBUG, 
SU_TRACE_NONE , 
0, 

L" " , 

SOURCENAME , 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) ; 



rc = MAPPER_DB_RC_FAILED; 
CString error; 

error . Format ( _T ( "mapperjib : ; make_phone_permanent ( ) . 
Could find temporary phone, temp ID = %ld, TAPI id = %ld. M ) / 

temp__id, device_id ) ; 
su_log_message ( 0, 

SU_JDEBUG, 
SU_TRACE_NONE , 
0, 

L" " , 

SOURCENAME, 

LINE , 

0, 
0, 

NULL , 

(LPCTSTR) error ) ; 

} 



su_log__message 



0, 



else 

{ 



return ( rc ) ; 

} 



enum MAPPER__DB__RC 

{ _ MAPPER_DB_RC_GOOD = 0, 

MAPPER_DB_RC_FAILED = 1, 

MAP PER_DB_RCJBAD_P ARAM = 2 , 

MAPPER_DB_RC_NOT_FOUND = 3, 

MAPPER__DB_RC_TIMEOUT = 4, 

MAPPER_DB_RC_DEVICE_NOT_OPEN = 5, 
MAP PER_DB_RC_OBJECT_ INVALID = 6 } ; 



enum EVENT_ INDICATOR 

{ EVENT_INDICATOR_NONE = 0, 

EVENT_INDICATOR_SEND_EVENT = 1 } ; 



const ULONG TEMP__BIT = 0x80 000000; 

#define MAPPER_DB_SEM _T ( n MAPPER_DB_SEM" ) 

const MAPPER DB SEM WAIT = 2000; // 2 second max wait 
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enura MONITORS TATTJS 

{ MONITORS_LOST = 0, 

MONITORS_NOT_LOST = 1 } ; 



class mapper_db 

10 public: 

friend mapper__db& get_mapper_db ( ) ; 

friend class static_line_manager ; 
15 friend class open_line_manager ; 

private : 

mapper_ db ( ) ; 



20 BOOL valid ; 



25 



30 



HANDLE mapper_db_sem; 

s t a t i c_phone_manager 
static_line_manager 
open_phone_manager 
op e n_l i ne__manag e r 
request_id_ manager 
call_manager 
static_address_manager 
addres s_manager 



s t a t i c_phone_mgr ; 

s t a t i c_l i rie_mgr ; 

open_phone_mgr ; 
open__line_mgr ; 

r e que s t _i d_mgr ; 

call__mgr ; 
s t at i c_addr e s s_mgr ; 

address_mgr; 
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DWORD line_device_id_base; 
DWORD phone_device_id_base ; 
DWORD next device id; 



40 



45 



50 



MAPPER_DB_RC do_async_f ai lures ( tapi_object * ); 
MAP PER_DB_RC do_delete__call ( tapi_call * } ; 

MAPPER_DB_RC do_delete_open_phone_device { tapi_open_phone 
MAPPER_DE_RC do_delete__open_line_device { tapi_open_line * 
MAP P ER_DB _RC do_delete_static_devices ( device_list &, 

EVENT_IND1CAT0R) ; 

MAPPER_DB_RC do_add_stat ic_devices ( device_list&, 

EVENT_INDICATOR ) ; 

public : 



- mapper _db ( ) ; 



55 BOOL validate () const; 

BOOL validate ( const tapi_open_line *, 
ULONG=0 ) const; 

BOOL validate ( const tapi_ppen_jphone *, 
ULONG=0 ) const; 

60 BOOL validate ( const tapi_call *, ULONG=0 ) 

const ; 

tapi_open_line * handle_to_ob j ect ( HDRVLINE ) const; 

tapi_open_phone * handle_to_obj ect { HDRVPHONE ) const; 

tapi_call * handle_to_object ( HDRVCALL ) const; 

65 HDRVLINE ob j ect_to_handle ( const tapi_open__line 

* ) const; 



36 

HDRVPHONE ob j ect_to_handle ( const 

tapi_open__phone *) const; 

HDRVCALL ob j ect_to_handle ( const tapi_call * ) 

const / 

void set_device_id__base ( DWORD, DWORD ) ; 

void get_device_id_base ( DWORD *, DWORD * ) const; 

USHORT get_jium_line — devices ( ) const; 

USHORT get_num_phone — devices ( ) const; 

MAPPER_DB_RC create_open_device ( DWORD, tapi_open_line **, 
ULONG * ) ; 

MAPPER_DB_RC create_open_device ( DWORD , tapi_open_phone **, 
ULONG * ) ; 

MAPPER__DB_RC delete_open_device ( tapi__open_device ** ) ; 
MAPPER_DB_RC get_s tatic_device ( DWORD , tapi_static_line ** } 

const; 

MAPPER_DB_RC get_static_device ( DWOR*D, tapi__static_phone ** ) 

const; 

MAPPER_DB_RC get_open_device ( const CString&, tapi_open_line 
**, tapi_address ** } const; 

MAPPER_DB_RC get_open_device C const CString&, tapi_open_phone 
** ) const; 

MAPPER_DB_RC lock_open_device ( tapi_open_device *, ULONG=20 00 



) 



MAP PER__DB_RC unlock_open_device ( tap i_open_de vice * ) ; 
MAPPERJDBJRC create_call { tapi_address *, tapi_call **, 

ULONG *, 

EVENT_INDICATOR=EVENT_INDICATORJSrONE ) ; 
MAPPER_DB_RC delete_call ( tapi — call ** ) ; 

MAP P ER_DB_RC move_call__to_old_call_lis t ( tapi_call * ) ; 
MAP PER_DB_RC create_reques t_id ( USHORT , DWORD, 



tapi_open_device *, 
* = NULL ) ; 

MAPPER DB RC delete_reques t_id ( USHORT, DWORD *, 



) ; 



}; 



tapi_open_device **, 

MAPPER_DB_RC create_devices ( device_list& ) ; 
MAPPER_DB_RC update_devices ( device_list& ) ; 



MAPPER_DB_RC close_all_devices ( ) ; 

MAPPER_DB_RC process_link_down ( ) ; 

MAPPERJDBJRC process__link_up ( MONITOR_STATUS ) ; 

MAP PER__DB _RC process_messages_lost () ; 



MAPPER JDB_RC make__line_permanent ( DWORD , DWORD ) ; 
MAPPER_DB_RC make_phone_permanent ( DWORD, DWORD ) 



tapi_call 



tap i_call 



^include " stdafx . h" 



#include "tapi *h M 
#include "tspi.h" 



37 



#include "mu_devls . h" 

5 

#include "su.h" 
DEF INESOURCE INFO ; 

#include IT su_shdat . h" 

#include r 'cdb_main . h" 

10 #include " sh_pl_ad . h" 



device_list : :device_list () 
15 : valid (FALSE) , device list p (NULL) 
{ ~ 



20 



25 



30 



35 



40 



45 



50 
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init 0 ; 

} 



device list :: -device list() 

{ 

delete [] device_list _j? ; 



void device list:: init ( ULONG num_entries ) 

{ 

valid = FALSE; 

delete [] device_list_p ; 



device_list_p = new DEVICE_LIST_ENTRY [num_entries] 
if ( device listjp 1 ~ NULL ) 

{ 

num_device_list_entries = 0; 
max_device_list_entry = num_entries - 1; 
next_device_list_entry = 0; 



valid = TRUE; 



BOOL device list :: validate ( ) const 

60 { 

if ( valid == FALSE ) 
{ 

CString error; 

65 error. Format ( _T ("Device list object is invalid") 
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su_log__message ( 0, 

SUJDEBUG, 



SU__TRACE_NONE , 
0 t 

_T ( n " ) , 
SOURCENAME , 

LINE , 

(USHORT) valid, 
0, 

NULL, 

(LPCTSTR) error ) ; 



return ( valid ) ; 



ULONG device_list : :get_num_entries (} const 
ULONG num_entries = 0; 



if { valid ) 

{ 

num entries = num device list entries; 

} _ _ 

else 

{ 

CS tring error; 

error. Format ( _T ("Device list object is invalid") 
su_log_message ( 0, 

SUJDEBUG, 
SU_TRACE_NONE , 

_T ( " " ) , 
SOURCENAME, 

LINE , 

(USHORT) valid, 
0, 

NULL , 

(LPCTSTR) error ); 



} 



return ( num entries ) ; 



BOOL device_list : :entry_in_object ( DEVI CE_L I S T_ENTRY *entry_jp 
const 

{ 

BOOL rc = FALSE; 

if ( valid ) 
{ 

for ( ULONG i = 0; i < num device list entries; ++ 



0 ) 



} 

else 
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DEVICE__LIST_ENTRY *dp; 
dp = device_list_j? + i; 

if ( wcscmp ( dp- >extension, entry _p- >extension) 



{ 



rc = TRUE; 
break; 



CString error; 

error. Format ( _T{ "Device list object is invalid") ) 



su_log__message 



0 , 



SI3MDEBUG, 
SU_TRACE_NONE , 
0, 

„T ( " n ) , 
SOURCENAME, 

LINE , 

(USHORT) rc, 
0, 

NULL , 

(LPCTSTR) error ) ; 



return ( rc ) ; 



BOOL device list:: add device { 



BOOL rc = FALSE; 



const CString& extension/ 

USHORT device_type, 
USHORT skip_digits ) 



if ( (valid == TRUE) (num_device_list_entries > 

max device list entry) ) 

" { " ~ 

DEVTCE_LIST_ENTRY *temp_p = 

new DEVICE_LIST_ENTRY [ (max_device_list_entry + 1) 

ENTRIES TO STEP] ; 



if ( temp_jp ! = 0 ) 

memcpy { temp_p, 

devi c e_l i s t_j? , 

sizeof { DEVI CE_L I S T_ENTR Y ) * 

(max_device__list_entry +1) ) ; 



max device _1 is t entry += ENTRIES_TO STEP; 
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} 

else 



delete [] device_list__p ; 
device__li st _j? = temp_p; 
rc = TRUE; 



rc - FALSE; 



memory" ) ) ; 



CString error; 

error. Format ( T( "Could not allocate system 



su_log_jnessage ( 0, 

SU_DEBUG , 
SU_TRACE_NONE , 
0, 

T C " " ) / 

SOURCENAME , 

LINE , 

(USHORT) rc, 
- 0, 

NULL , 

(LPCTSTR) error ) ; 

) 1 

else if ( valid = = TRUE ) 

{ 

rc = TRUE; 

} 

else 

{ 

CString error; 

error. Format ( _T("Device list object is invalid") ); 
su_log_message ( 0, 

SU_DEBUG, 
SU_TRACE__NONE , 
0 , 

_T ( » " ) , 
SOURCENAME , 

LINE , 

(USHORT) rc, 
0, 

NULL, 

(LPCTSTR) error ) ; 



if ( rc == TRUE ) 

{ 

memcpy ( & (device_list_p + num_device_list_entries) 

> extension, 

(LPCTSTR) extension, 
{extension. GetLength ( ) +1) * 

Sizeof (TCHAR) ) ; 

(device_list_j? + num_device_list__entries) - >skip_digits 

skip_digits ; 



device_type; 
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(device__list_p + num_device_list_entries) - >device__type 



++num device list entries ; 



cnfg_db& cdb = get_cnf g_db ( ) ; 



if ( cdb. debug tracing on ( DBG DEVICE LIST BIT ) ) 

{ ~~ 

CString error; 

error . Format ( _T ("Device List : : add_device ( ) . Extension 
%s, skip digits = %d, device type = %d"), 



device_type ) / 

su_log__message ( 



} 

return { rc ) ; 



0, 



extension, skip_digits , 



SU_DEBUG , 
SUJTRACE JSTONE , 
0, 

_T ( » » ) , 
SOURCENAME , 

LINE , 

(USHORT) rc, 
0, 

NULL, 

(LPCTSTR) error 



BOOL device_list : : get_next_device ( CString& 

*device_type_p , 

*perm_l ine_id_p , 

*perm_jphone_id__p ) 

BOOL rc = FALSE ; 

USHORT device__type = 0 ; 

ULONG perm__line_id = 0; 
ULONG perm_johone_id = 0 ; 



extension, 

USHORT 

ULONG 

ULONG 



if { (valid == TRUE) (device_type_p ! = NULL) 

(perm line id_p !- NULL) (perm_phone_id_p I- NULL) 

{ 

if ( next_device_list_entry < num_device_lis t_entries ) 



extension = (device_list_jp + 
next_device_list_entry) ->extension; 

device_type = (device_list_j? + 
next_device__list_entry) ->device__type ; 



USHORT skip = (device_list_p 
next device_list_entry) - >skip_digits ; 
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ttifdef UNICODE 

#else 

#endif 



} 

else 

{ 



} 



perm_line_id = _wtol ( (LPCTSTR) extension + skip ) 
perm_line_id = atoi ( (LPCTSTR) extension + skip ); 
perm_phone_id = perm_line_ id; 



*device_type_p = device_type; 
*perm_line_id_jp = perm__line_id; 
*perm_jphone_id_p = perm_j?hone_id; 



+ +next_de vi c e_l i s t_ent ry ; 
rc = TRUE; 



CStrmg error; 
error . Format { __T ("Device list not accessible. Device 
type ptr = %lx, line ID ptr = %lx, phone ID ptr = %lx"), 

device_type_ p, perm_line_id_p , 

perm_phone_id_p ) ; 

su_log_message ( 0, 

SUJDEBUG, 

SUJTRACEJSTONE, 

0, 

T { " " ) / 

SOURCENAME , 

LINE , 

(USHORT) valid, 
0, 

NULL/ 

(LPCTSTR) error ) ; 



cnfg_db& cdb = get__cnf g_db ( ) ; 



if ( cdb.debug_tracing_on ( DBG_DEVI CE_L I ST_B IT ) ) 

{ 

CSt ring error; 

error . Format ( __T ( "Device List : : get__next_device ( ) . 
Extension = %s, device type = %ld, perm line id = %ld, perm phone id 
= %ld» ) , 



perm_line_id, perm__phone_id ) ; 

su log message { 0, 



extension/ device_type, 



SUJDEBUG , 

SU JTRACE_NONE , 

0 , 

_T { " " ) , 
SOURCENAME , 

LINE , 

(USHORT) rc, 
0 / 

NULL , 

(LPCTSTR) error ) ; 
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return ( rc ) ; 

} 



BOOL device_list : : create__dif f erences ( const device_list& 
new_list , 

device_listSc added_list, 

device list& deleted list ) const 

{ 

BOOL rc = FALSE; 



added_list . init ( ) ; 
deleted list. init (); 



if ( (valid == TRUE) 

(added_list .validate () == TRUE) ScSc 
(deleted_list .validate () == TRUE) 
(new list .validate 0 == TRUE) ) 



++i) 
i) ) 



{ 

rc = TRUE; 

for ( ULON"G i = 0; i < new_list .num_device — lis t — entries ; 

{ 

if ( I (entry__in_ob j ect ( new_list . device_list_p + 

{ 

DEVICE_LIST_ENTRY *dp = 
new^list . device_lis t_p + i; 

rc = added_list . add_device ( dp- >extension , 

dp - >device_type , 
dp->skip__digits ) ; 

if { rc == FALSE ) 

{ 

CString error; 

error . Format ( T( "Error adding device 



to list") 



su_log_message ( 0, 

SU DEBUG, 



SU_TRACE_NONE , 
0, 

_T ( » » ) , 
SOURCENAME , 

LINE , 

(USHORT) rc, 
0, 

1STULL, 

(LPCTSTR) error 



) ; 
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break; 



{ 



device_list_p + i) ) ) 



i; 



if ( rc != FALSE ) 

{ 

for ( i = 0; i < num_device_list entries; ++i ) 



if ( ! (new__list . entry_in_obj ect { 



{ 



DEVI CE__L I S T_ENTR Y *dp = device_lis t_p . ,+ 



rc = deleted list. add device ( 



dp- 



extension, 



dp->device_type, 
dp->skip_digits } ; 



device to list") ); 



if ( rc 

{ 



FALSE ) 



CString error; 
error . Format ( __T ( "Error adding 



su_log_message 



0, 

SU DEBUG, 



SU JTRACEJKTONE , 

SOURCENAME, 
(USHORT) rc, 

(LPCTSTR) error ) ; 



0, 
T ( " " ) , 



LINE 



0 , 

NULL, 



break; 



} 

else 

{ 

CString error,- 

error . Format ( _T ("A device list object is invalid, 
current = %d, added = %d, deleted = %d, new = %d" ) , 

valid, added_list .validate (} , 
deleted_list . validate ( ) , 
new list .validate ( ) ); 



s u_l og_me s s age 



( 



0 , 



SU_DEBUG, 
SU_TRACE_NONE , 

T ( » » ) , 
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SOURCENAME , 

LINE , 

(USHORT) re, 

NULL, 

(LPCTSTR) error ) ; 



cnfg_db& cdb = get_cnf g_db ( ) ; 



if ( cdb.debug_tracing„on ( DBG_DEVICE_LISTJ3IT ) ) 

{ 

CString error; 

error. Format ( _T( "Device List : : create_dif f erences ( ) . 



) ; 



su_log_message ( 0, 



£U_DEBUG, 
SU_TRACE_NONE , 
0 , 

_T ( " " ) , 
SOURCENAME, 

LINE , 

(USHORT) rc, 
0, 

NULL , 

(LPCTSTR) error ) 



return ( rc ) ; 

} 



ULONG device_list : :get_raw_format_size () const 

^ ULONG size = 0; 

if ( valid == TRUE ) 

^ size = sizeof ( num_de v i c e_l i s t_en t r i e s ) + 

(num_device_lis t__en.tr ies * 
sizeof ( D E VI CE_L I S T_ENTR Y ) ) ; 
} 

else 

{ 

CString error; _ t , , 

error . Format ( _T ("Device list ob]ect is invalid ) ) 

su log message ( 0, 

- - SU_DEBUG , 

SU_TRACE_NONE , 

jr ( » " ) , 

SOURCENAME , 

LINE , 

(USHORT) valid, 
0, 

NULL, 

(LPCTSTR) error ); 
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cnfg_db& cdb = get_cnfg_db ( ) ; 

if ( cdb,debug_tracing_on ( DBG_DEVICE_LIST_BIT ) ) 
CString error; 

error. Format ( _T("Device List : : get_raw_f ormat_s ize ( ) 
Size a %ld") , 

size ) ; 
su_log_jnessage ( 0, 

SUJDEBUG, 
SU__TRACE_NONE , 
0, 

_T ( » » ) , 
SOURCENAME , 

LINE , 

0, 
0 , 

NULL, 

(LPCTSTR) error ); 



return ( size ) ; 

} 



ULONG device_list : : get_device_list_in_raw_f ormat ( ULONG size, 
BYTE *data_p ) const 

{ 

ULONG bytes_copied = 0; 

ULONG data_size = get_raw_f ormat_size ( ) ; 

if ( ( valid TRUE) (data_p != NULL) ScSc (size > = 

data size) ) 

_ { 

* (ULONG *)data_p = num_device_li st_en tries ; 

memcpy ( (data_jp + sizeof {rmrn_device_ lis t_entries } ) 
device_list_p , 
data_size - 
sizeof (num_device_list_entries) ) ; 

bytes copied = data size; 

} 

else if ( valid == FALSE ) 
{ 

CString error; 

error. Format ( _T( "Device list object is unusable. 
Requested data ptr = %lx, size « %ld" ), 

data_p, size ) ; 

su_log_message ( 0, 

SU_DEBUG, 
SU_TRACE_NONE , 
0, 
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_T ( » » ) , 
SOURCENAME , 

LINE , 

(USHORT) valid, 
0, 

NULL, 

(LPCTSTR) error }; 



cnfg_db& cdb = get_cnf g_db ( ) ; 

if ( cdb. debug tracing on ( DBG DEVICE LIST_BIT ) ) 

{ 

CSt ring error; 

error . Format ( _T ( "Device 
List : :get__device_list_in__raw_f ormat { ) . Request pointer - %lx, reques 
size = %ld, bytes copied = %ld") , 

data_jp/* size , bytes_copied ); 
su_log__message { 0, 

SUJDEBUG , 
SUJTRACE_JNONE , 
0, 

JT ,f ) , 
SOURCENAME, 

LINE , 

0, 
o , 

NULL, 

(LPCTSTR) error ); 



return ( bytes copied ) 

} 



BOOL device_list :: set_device_list_from_raw_f ormat C const BYTE 
*data _p ) 

{ 

ULONG data_size = 0; 
valid FALSE; 



if ( data_p ! = NULL ) 

this->init ( * (ULONG *)data_p } 



if ( valid 

{ 



num_device_list_entries = * (ULONG *)data_j); 



data_size = num__device_lis t_entries * 
sizeof (DEVICE LIST ENTRY); 



memcpy ( device_list_p , 
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sizeof (num device__list_entries) ) , 



} 

else 

{ 



} 



(data_ p + 
data_size ) ; 



CSt ring error; 

error . Format { _T ( "Device list object is invalid") ) 



su_log_message ( 



SU_DEBUG , 

SU_TRACE_NONE, 

0, 

T ( " " ) / 

SOURCENAME, 

LINE , 

(USHORT) valid, 
0, 

NULL, 

(LPCTSTR) error ) ; 



cnfg_&b& cdb = get_cnf g_db ( ) ; 



if ( cdb. debug tracing on ( DBG DEVICE_LIST_BIT ) ) 

{ " 

CString error; 

error . Format { _JT( "Device 
List : : set_device__list_f rom_raw_f ormat ( ) . Request pointer = %lx, 
of list= %ld M ) , 



su_log_jnessage ( 



data_p, data^size ) ; 
0, 

SU_DEBUG, 
SU_TRACE_NONE , 
0, 

_T ( » » ) , 
SOURCENAME , 

LINE , 

0, 
o , 

NULL, 

{LPCTSTR) error ); 



} 



return ( valid ) ; 



const USHORT EXTENS ION_LENGTH = 17; 
struct DEVICE LIST ENTRY 



WCHAR 

USHORT 

USHORT 



extension [EXTENS I ON_LENGTH] 
skip_digits ; 
device_type ; 



}; 



const USHORT INITIAL ENTRIES = 1000; 



// Entries to start wi 
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const USHORT ENTRIES JTOJSTEP = 100 0; // Alloc this many more 

when out 



class device list 

{ 

private : 

BOOL valid; 



DEVICE_LIST_ENTRY *device_list_p ; 

ULONG num_device_list_entries ; ULONG 
max_de v i c e__l i s t__en t ry ; 

ULONG next_device_list_entry; 

BOOL entry_in_object ( DEVICE_LISTJENTRY * ) const; 
public : 



device_list () ; 
~device_list ( ) ; 

void init ( ULONG num^entries = 

INITIAL^ ENTRIES } ; 

BOOL validate () const; 

ULONG get_num_en tries ( ) const; 

BOOL add_device ( const CString&, USHORT, USHORT ) ; 
BOOL get_next_device ( CString&, USHORT *, ULONG *, ULONG 

BOOL create^ dif f erences ( const device_list&, 

de vi c e__l i s t & , 
device list& ) 



* ); 

const; 
const; 

}; 



ULONG get_raw_f ormat_size ( ) const; 

ULONG get_device_list_in__raw_f ormat ( ULONG, BYTE * ) 
BOOL set device list from raw format ( const BYTE * ) ; 



// 

#include "stdafx.h" 

#include <afxmt.h> 

#include "tapi .h" 

#include " tspi.h" 

# inc lude " mu_devl s.h" 

# include f, mdb_opti . h" 

#include ff mdb_tdat . h" 

#include ,, mdb_siem . h" 

#include "mdb_tobj . h" 

#include "mdb_mgrs.h" 

# inc lude "mdb_mdb . h" 

#include " ti_dbapi . h" 

#include 11 ti build. h" 
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#include "su.h" 



#include "su_shdat.h" 
5 # include »cdb_main . h n 
#include " sh_jpl_ad . h" 
#include "sujcorr.h" 
#include »ti_intf .h" 
#include "oss_acl . h M 

10 

#include " sh_stats . h" 
#include »mu_aclm.h" 

15 

# include "mu_buf f m . h" 

#define INCL_BASE 

# include "su.h" 
20 • #include "mpcommon.h" 

#include "ugglobal.h" 

#include "ugstat s . h" 

#include "ugerror.h" 

#include "asnlcode . h" 
25 #include "oss_csta.h" 

^include "mp_defs.h n 

#include »rr_defs.h" 

# inc lude 11 evde f s . h " 

30 #include "pbaclutl . h" 

^include "pbacl_rr . h" 

#include "roseprot.h" 

#include "plglobal .h" 

35 

#include "rrglobal . h" 
#include " rr_platf . h" 
# inc lude "rr_inc.h" 
40 #include "rrrose.h" 

char acl_signon_password [] = "CSTAGW" ; 
DEFINE SOURCE INFO ; 
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RET CODE mp get_acl_devices_list ( 

~MP_DEVICES_LIST_REQUEST_TYPE request_type) 



') 
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static const CStrmg 
_T ( M mp_get_acl_devices_list () 
" RET_C0DE 

CNFG_DB_RC 
55 MAPPER_DB_RC 

BUFF_MGR_RC 

WCHAR 

trace_buff [MAX — BYTES _PER_LOG__ENTRY] 
SAVED ATA 
60 DWORD 

ACL JDEVICES JL.IST_REQ JTIMEOUT ; 

MP_BUFFER 

ReferenceNumber 

Get_Switch_Fn_Dev_Request 

65 NULL; 

device list 



func_name = 
rc = GOOD; 

cf rc = CNFG JDB_RC_GOOD ; 
db~rc = MAPPER_DB_RC_GOOD; 
buff rc = BUFF MGR_RC_GOOD 



saved_data = {o}; 
ref id_timeout = 

*acl_msg_p = NULL; 

* ac l_r e f _num_p - NULL; 

*acl_get_devices_list_rq_p 

dev list; 
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BOOL send_acl_re quest = FALSE; 

cnfg_db& cf_db = get_cnf g_db ( ) ; 

if (cf db. debug tracing on (DBG RQST MAPPER BIT) == TRUE) 
{ _____ 

wsprintf (trace_ buf f , _T( n Entering %s"), func^name) ; - 
su_log_me s s age ( 0 ; SUJDEBUG , SU_TRACE JtTGNE , 0 , NULL , 
^ SOURCENAME, LINE , 0, 0, NULL, trace_buf f ) ; 

mapper_db& mp__db = get_mapper__db ( ) ; 

buffer_mgr &buf f er_manager = get_acl_buf f er_mgr { ) ; 
cf_rc = cf__db .get_device_list (dev__list) ; 

if (cf_rc == CNFGJDB_RC_GOOD 

dev__l is t .validate () == TRUE 
dev_list .get — num — entries ( ) != 0) 

db_rc - mp_db . create__devices (dev_list) ; 
if (db_rc == MAPPER JDB_RC_GOOD) 

if (dev_list . get_num_entries ( ) -= 0) 
send_acl_request = TRUE; 

else 

{ 

rc = GOOD; 

send_acl_request = FALSE; 

} 1 

else 
{ 

su_log_message ( 0 , SUJDEBUG , SUJTRACEJNONE , 0 , NULL , 

SOURCENAME, LINE , db_rc , 0, NULL , 

_T ( "creat_devices returned error") ) ; 

rc = GOOD; 

send acl request = TRUE; 

> 1 " " 

else 

{ 

send acl request - TRUE; 

. 1 " " 

else if (request type == CHECK DEVLIST REQUEST) 
{ ~ ~ 

cf_rc = cf — db.get_device — list (dev_list) ; 

if (cf_rc == CNFGJ3B_RC_GOOD 

dev_list. validate () == TRUE 

dev list. get nurn entries () != 0) 

{ ~ " 

db_rc = mp_db . create_devices (dev_list) ; 
if (db rc == MAPPER DB RC GOOD) 
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{ 

rc = GOOD; 

} 

else 

5 { 

su_log_message ( 0 , SUJDEBUG , SU_TRACE__NONE , 0 , NULL , 

SOURCENAME, LINE , db_rc, 0, NULL; 

_T ( "creat^devices returned error")); 
10 rc = ERR NUM RR ERROR; 

> ' 

else 

15 < 

rc = ERR NUM RR ERROR; 

. 1 

^ else if (request_type == ADMIN_REQUEST) 

send acl request = TRUE; 

} ~ ~ 

else 
* oc { 

*i3 25 su_log_message(0, SU_DEBUG, SU_TRACE_NONE , 0, NULL , 

if: SOURCENAME , LINE , reques t_type , 0, NULL , 

_T ("Parameter Error - request_type" ) ) ; 
?* rc = ERR NUM RR ERROR ; 

} - - - 



30 

if (rc == GOOD ScSc send acl request TRUE) 

{ 

buff_rc = buf f er_manager . get_buf f er ( (BYTE **) &acl_msg_jp) ; 
35 if (buff rc J= BUFF MGR RC GOOD) 

{ 

su_log_message(0, SU_ERR0R, SU_TRACE_NONE , 0, NULL, 

SOURCENAME, LINE , buff_rc, 0, NULL , 

_T ( "get_buf f er returned error")); 
40 rc = ERR NUM RR ERROR; 

} - - - 

if (rc == GOOD) 

4o rc = (USHORT) get__acl_reques t_st rue t_po inter ( 

gt_Switch_Fn_pev_Request_chosen, 
(ULONG **) &acl_get__devices_list_rqj> , 
&ac l_ref _num_p , 

&acl_rnsg_p->mp_struct . u . acl_struct . acl_services) ; 
50 if (rc != GOOD) 

{ 

su_log_mes sage ( 0 , SUJDEBUG , SU_TRACE_NONE , 0 , NULL , 

SOURCENAME, LINE , rc, 0, NULL, 

_T ( T, get_acl_request_struct_pointer returned 
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rc = ERR NUM RR ERROR; 



if (rc == GOOD) 
{ 

memset (acl_get_devices_list_rq _jp , 0 , 
65 sizeof (Get_Switch_Fn_Dev_Request) ) ; 
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acl_get_devices__list_jrq_j?- >getSwitchingFunctionDevices = 

getSwitchingFuncDevices ; 
acl_get_devices_list_j:q_j3->aclDeviceType = aclstation; 

5 acl_msg_p->mp_struct .choice = ACL_STRUCT__CHGSEN; 

acl_msg_p->mp_struct . u . acl_struct . acl^services . choice = 

invokeService__chosen,* 
acl_msg_p->mp_header . dest_link_id - ACL_LINK; 
acl_msg_j?->mp_header . dest_port_id = NO_TAP I_PORT ; 
10 acl_msg_p->mp_header . source_link_id = CSTA__LINK; 

acl_msg__p->mp__header . source_port_id = 0; 
acl_msg_p->mp_header .message__type = 
A GET SWTCH FUNG DEV REQ STRUCT; 
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saved_data. tspi_function_type = 0; 



sizeof 


(MP_ 


_STRUCT).,; 


// 


not 


used 


// 


not 


used 


// 


not 


used 


// 


not 


used 


// 


not 


used 


// 


not 


used 


// 


not 


used 



saved_data.unique_open__device_id = 0; 
saved_data . call_obj ect_p = NULL ; 
20 saved_data.unique_call_object__id = 0; 

saved_data . current_callid = 0; 
saved_data . trace_correlator = 0; 
saved_data .buf f erjp = (BYTE *} acl__msg_p; 
saved data. device recuest type = request type ; 

25 } * - - - 

if (rc == GOOD) 

30 rc = rose__send_acl_req ( 

&acl_ms g_p - >mp_heade r , 

&acl_msg _j?->mp_struct , 

&saved_data, 

ref id_timeout , 
35 NULL , 

NULL, 

NULL) ; 
if (rc != GOOD) 

40 su_log_message (0, SU_ERROR, SUJTRACEJtfONE , 0, NULL, 

SOURCENAME , LINE , rc, 0, NULL, 

T ( "rose — send_acl__req returned error") ) ; 
rc = ERR NUM_RR__ERROR; 

} "" 

45 else 

( 

rc = ERR NUM RR SENT OK; } 

} 

} 

if (rc ! = ERR_NUM_RR_SENT__OK acl_msg_p i = NULL) 

buff_rc = buf fer_manager. freejbuffer ( (BYTE *) acl_msg_p) ; 
55 if (buff_rc 1 = GOOD) 

su_log_message (0, SU_ERROR, SU_TRACE_NONE, 0, NULL , 

SOURCENAME , LINE , buff_rc, 0, NULL , 

T ( " free buffer returned error"))/ 

60 rc = ERR NUM RR ERROR; 

} - - - 

} 

if (cf db. debug tracing_on (DBG_RQST_MAPPER__BIT) == TRUE) 

65 { 

wsprintf (trace_buf f , _T( rf Exiting %s"), func_name) ; 
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su_log_message (0, SUJDEBUG, SU_TRACE_NONE , rc, MILL , 
SOURCENAME , LINE , 0, 0, NULL , trace buff); 



return (rc) ; 

} 

#include "stdafx.h" 
#include <afxtnt.h> 
#include "tapi.h" 
#include "tspi .h" 

#include "tnu devls.h 



#include 
# include 
#include 
#include 
# include 
# include 



"mdb_opti .h" 
"mdb_tdat . h" 
"mdb_siem.h" 
"mdb^obj .h" 
"mdb_mgrs . h IT 
"mdb mdb.h" 



#include " ti_dbapi .h" 



# i nc lude " t i_bui 1 d . h " 

# include "su.h" 

#include " su_shdat . h" 
#include " cdb jmain . h " 
#include "sh_pl_ad . h" 

#include " su_tcorr . h" 

#include "ti_intf.h" 

#include M oss_acl .h" 
#include "sh_stats . h" 

# include "mu__aclm . h" 

#include "mu__buf f m . h M 

#include "su.h" 

# include "mpcommcn.h" 

#include ,r ugglobal . h ,f 

#include "ugstats.h" 

#include "ugerror . h" 

#include "asnlcode - h" 
#include "oss_csta . h" 

# inc lude " mp_de f s . h " 

#include M rr__def s .h" 

#include "evdefs.h" 

#include "pbaclutl . h" 

# inc lude " pbac l_r r . h " 

#include "roseprot.h" 

#include "rr_inc .h" 

tinclude "plglobal . h" 

DEFINESOURCEINFO ; 

RET_C0DE mp_map_acl_devices_list_resp { 
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30 



{ 



MP HEADER * in_Jaeader_p , 
SAVED ATA *saved__ data _p , 
MP_STRUCT *in_msg_p) 



static const CString 
T ( "mp_map_acl_devices_list_resp") ; 

~ RET_C0DE 
BOOL 

BUFF_MGR_RC 
1 0 CNFG_DB_RC 

MAPPER_DB__RC 
USER_REQID_MGR_RC 
USER_REQID_MGR_RC_GOOD ; 
WCHAR 

15 trace_buff [ MAX_B YTE S_jP ER_LOG — ENTRY ] ; 
ReferenceNumber 
AclServices 

Get_Switch_Fn_Dev_Response 

NULL; 
20 USHORT 

DeviceConf igRecords_ 

cnfg_db& cf_db = get_cnf g_db ( ) ; 



f unction_name = 

rc = GOOD; 

bool_rc = TRUE ; 

buff_rc = BUFF_MGR_RC_GOOD; 

c f rc = CNFG_DB_RC_GOOD ; 

db~rc = MAPPER_DB_RC_GOOD; 

ref rc = 



*acl_ref_num_j> = NULL; 
*acl_msg_p = NULL; 
*acl__devices_list_rs _jp 



index=0 ; 
*next_dev_p 



NULL; 



25 if (cf_db.debug_tracing_on(DBG_RQST_MAPPER_BIT) = = TRUE) 



} 



^nrintf(trace buff, T( "Entering %s\n"), function_name) ; 
a?l£ ^ sag (0 SU DEBUG, SU_TRACE_NONE , 0 NULL, 
" iouScENAME, 1lINE_, 0, 0, NULL, trace_buf f ) ; 



mapper_db& mp_db = get_mapper_db ( ) ; 
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40 



if 

{ 



(in_header_p = = NULL) 

SU log_message(0, SU_DEBUG, SU_TRACE_NONE , 0, NULL, 

~ SOURCENAME, LINE , 0, 0, NULL, 

TC'Bad input parameter - m_header_p )); 
rc =~RR MAP PING_FAI LURE ; 
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if 

{ 



(saved_data_p == NULL) 

su log message (0, SU_DEBUG, SU_TRACE_NONE , 0, NULL, 

~ SOURCENAME, LINE , 0, 0, NULL, 

T ( "Bad input parameter - saved_data_p )); 
rc =~RR MAP PING_FAI LURE; 
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60 



65 



if 
{ 



} 

if 

{ 



(in_msg_p = = NULL) 

su log message (0, SU.DEBUG, SU_TRACE_NONE , 0, NULL, 

~ SOURCENAME, LINE , 0, 0, NULL, 

T ( "Bad input parameter - injnsgj?" ) ) ; 
rc =~RR MAPPING_FAILURE; 



(rc == GOOD) 

acl_msgj> = & (in„msg_p- >u . acl_struct . acl„services) ; 

rc = get_acl_response_struct_pointer ( 
gt Swtch_Fn_Dev_Response_chosen, 
(ULONG **) Scacl_devices_list_rs_p, 
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&acl__ref _num_jp , 
acl_msg_p) ; 

if (re == GOOD) 
{ 

if (acl__devices_list_rs jp->acknowledgeCode == 

positiveAck) 



{ 



static device_list dev_list; 

if (acl_devices_list_rs_jD- >sttnCnf gBlckNmbr = = 0) 



} 



dev list . init ( ) ; 



next__dev__p = acl_devices_lis t__rs__p- 
>deviceConf igRecords ; 

index = 0 ; 

while (next dev p != NULL) 

{ ~ 

bool_rc = dev^list . add — device ( 
next_dev_p- 
>value . deviceConf igSet . localParty . u . 

Lc lPr ty_ext ens ionNumher , 

next_dev_jp- > value .DvcCnf gRcrd_aclDvcTyp , 
next_dev_jp- >value , DvcCnf gRcrd_skipDigits) ; 
if (bool rc FALSE) 



NULL, 



su_log_jnes sage ( 0 , SUJDEBUG , SU_TRACE_NONE , 

SOURCENAME, LINE , index, 0, NULL, 

JT<" bad add devices")); 
rc = RR_MAPPING_FAILURE; 
break; 



>next ; 



OxFFFF) 



next_dev__p = next_dev_p- 



index++; 
} // end while 

if (rc != GOOD) 
{ 

} 

else if (acl_devices_list_rs_p->sttnCnf gBlckNmbr = 

{ 



buf f er__mgr& buf f er_manager ~ 
get_acl_buf f er_mgr () ; 

buff_rc = 

buf f er_manager . f ree_buf f er (saved_data_jp- >buf f er_p) ; 

if (buff rc != BUFF MGR RC GOOD) 



{ 



NULL, 



su_log_message ( 0 , SUJDEBUG , SUJTRACE JSTONE , 

SOURCENAME , LINE , 0, 0, NULL , 

T( "can't free buffer")); 



acl__refid — manager = get_acl_ref id_mgr ( } ; 



ac l_r e f i d_mgr 5c 
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ref_rc - acl — refid — manager . f ree_user_request_id ( 
(USHORT) in_msg_p- 
>u. acl_struct . acl_services .u. 

returnResultsService . referenceNumber) ; 
if (ref rc ! = USER REQID MGR RC GOOD) 



{ 



NULL, 



START UP REQUEST) 



su_log_message (0, SU_DEBUG , SU_TRACE_NONE , 0, 

SOURCENAME , LINE , 0, 0, NULL , 

T( "can't free buffer")); 



} 

if (saved_data_p->device_request_type =- 

{ 



db_rc = 

mp_db . create_devices (dev_list) ; 

if (db rc != MAPPER DB RC GOOD) 

{ 7 " 

su__log_message (0 , SUJDEBUG, 

SU_TRACE_NONE , 0, NULL, 

SOURCENAME , LINE , db_rc, 0, NULL, 

_T("bad database") ) ; 
rc = RR MAPPING FAILURE; 

" ", 

else if { saved_data_p->device_request_type == 

ADMIN REQUEST) 

{ 

db_rc = 

mp_db .update_de vices (dev_list) ; 

if {db rc != MAPPERJDB RC_GOOD) 

{ 

su_log_message ( 0 , SUJDEBUG , 



SU TRACE NONE , 0, NULL, 



SOURCENAME , LINE , db_rc , 0, NULL, 

T("bad database") ) ; 



SU_TRACE_NON&, 0, NULL, 
NULL, 



db_rc = mp_db . create^devices (dev__list ) ; 

if (db rc 1= MAPPER DB RC GOOD) 

{ 

su_log_message (0 , SUJDEBUG, 

SOURCENAME , LINE , db_rc , 0, 

JT ("bad database") ) ; 
rc = RR MAPPING FAILURE; 



cf_rc = cf_db . set_device_list (dev_list ) ; 
if (cf rc != CNFG DB RC GOOD) 
{ - - - 

su__log_message (0, SUJDEBUG, SU_TRACE_NONE , 
saved_dat a_j? - >trace_correlator , NULL , 

SOURCENAME, LINE , db_rc , 0, NULL, 

_T( n bad database")); 

rc = RR MAPPING FAILURE; 



if (rc == GOOD) 
pl_list_update_complete (TRUE) ; 
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else 

{ 

pl — list_update_complete (FALSE) ; 

else 

{ 

mp__ref id_timeout () 

su_log_message(0, SUJDEBUG, SU_TRACE_NONE , 0, NULL, 

SOURCENAME , LINE , acl__devices_lis t__rs_p - 

:knowledgeCode , 0, NULL, 

_T( n bad ackCode") ) ; 
rc = GOOD; 

} 



else 

su_log_message (0 , SUJDEBUG, SUJTRACE_N0NE , 0, NULL, 
SOURCENAME/ LINE , rc, sizeof (MP_STRUCT) , 

(BYTE *) in_msg_p, 

_T("From get_acl_ response_struct_j?ointer" ) ) ; 
rc = RR MAPPING FAILURE ; 



if (cf db, debug tracing on (DBG RQST MAPPER BIT) == TRUE) 

{ ~ " 

wsprintf (trace_buf f , _T("Exiting %s\n"), function_jiame) ; 
su__log_me s s age ( 0 , SUJDEBUG , SU_TRACE_NONE , 0 , NULL , 
SOURCENAME , LINE , 0, 0, NULL, trace_buf f ) ; 

} ~~ ~~ 



return (rc) ; 



WHAT IS CLAIMED IS: 



59 



1 1 . A method for updating configuration information in a TAPI system, 

2 comprising: 

3 storing configuration information in a first configuration table object; 

4 requesting update static configuration information from a telephony 

5 device; 

6 receiving said update static configuration information; and 

7 storing said static update configuration information for system use as a 

8 second configuration table object. 

1 2. A method in accordance with claim 1 , further comprising generating a 

2 deleted devices configuration table object and an added devices configuration 

3 table object. 

1 

2 3. A method in accordance with claim 2, comprising notifying said TAPI 

3 system that each device in said deleted devices configuration table object has 

4 been dynamically deleted 

1 4. A method in accordance with claim 2, comprising notifying said TAPI 

2 system thafeach device in said added devices configuration table object 

3 has been dynamically deleted. 
1 

2 5. A TAPI system, comprising: 

3 means for storing configuration information in a first configuration table object; 

4 means for requesting update static configuration information from a telephony 

5 device; 

6 means for receiving said update static configuration information; and 

7 means for storing said static update configuration information for system use 

8 as a second configuration table object. 
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1 6. A system in accordance with claim 5, said storing means further comprising 

2 means for generating a deleted devices configuration table object and an added 

3 devices configuration table object. 

1 7. A system in accordance with claim 6, further comprising means for 

2 notifying said TAPI system that each device in said deleted devices configuration . 

3 table object has been dynamically deleted, 

1 8. A system in accordance with claim 6, further comprising means for 

2 notifying said TAPI system that each device in said added devices configuration 

3 table object has been dynamically deleted. 
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ABSTRACT OF THE DISCLOSURE 

ATAPl service provider may request configuration information from 
hardware such as a PBX. Configuration information received from the 
5 hardware is stored in a list and compared to the existing configuration list. 
Two new lists are then generated: an added list and a deleted list. All devices 
in the deleted list are deleted from the internal database and deleted 
messages are sent to the TAPI service provider. All new devices are 
temporarily added to the internal database and addition messages are sent to 
10 the TAPI service provider. The new device configuration list is then saved, 
and the added devices are marked as permanent. 
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I hereby claim foreign priority benefits under Title 35, United States Codes, § 1 19 of 
any foreign application(s) for patent or inventor's certificate listed below and have also 
identified below any foreign application for patent or inventor's certificate having a filing date 
before that of the application on which priority is claimed: 

PRIOR FOREIGN APPLICATION(S) Priority claimed 



(Number) 


(Country) 


(Day/month/year filed) 


Yes 


No 


(Number) 


(Country) 


(Day/month/year filed) 


Yes 


No 


(Number) 


(Country) 


(Day/month/year filed) 


Yes 


No 



I hereby claim the benefits under Title 35, United States Code, § 120 of any United States 
application(s) listed below and, insofar as the subject matter of each of the claims of this 
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application is not disclosed in the prior United States application in the manner provided by 
the first paragraph of Title 35, United States Code, § 1 12, 1 acknowledge the duty to disclose 
material information as defined in Title 37, Code of Federal Regulations, § 1.56(a) which 
occurred between the filing date of the prior application and the national or PCT international 
filing date of this application: 



(Application Serial No.) (Filing date) (Status) 

(patented,pending,abandoned) 



(Application Serial No.) (Filing date) (Status) 

(patented,pending,abandoned) 

I hereby claim the benefit under 35 U.S. C. 1 19(e) of any United States provisional application listed 
below: 



(Application Serial No.) (Filing date) (Status) 

Power of Attorney : As a named inventor, I hereby appoint the following attorney(s) and/or 
agent(s) to prosecute this application and transact all business in the Patent and Trademark 
Office connected therewith, (list name and registration number) 

Adel A. Ahmed, Reg. No. 29,606; Stanton C. Braden, Reg. No. 32,556; Robert T. Canavan, 
Reg. No. 37,592; Dexter K. Chin, Reg. No. 38,842; Joseph S. Codispoti, Reg. No. 31,819; 
Lawrence C. Edelman, Reg. No. 29,299; Andreas Grubert, Limited Recognition Under 37 
CFR §1 0.9(b); Mark H. Jay, Reg. No. 27,507;Stuart P. Kaler, Reg. No. 35,913; Rosa S. Kim, 
Reg. No. 39,728; David W. Laub, Reg. No. 38,708; Peter A. Luccarelli, Jr., Reg. No. 29,750; 
Jeffrey P. Morris, Reg. No. 25,307; Donald B. Paschburg, Reg. No. 33,753; Darryl A. Smith, 
Reg. No. 37,723; Heather S. Vance, Reg. No. 39,033; Scott T. Weingaertner, Reg. No. 
37,756; Robert A. Whitman, Reg. No. 36,966; and Ira Lee Zebrak, Reg. No. 31,147. 

Send correspondence to: Direct telephone calls to : 

Siemens Corporation Elsa Keller 

Intellectual Property Department Legal Administrator (908) 321-3026 

186 Wood Avenue South 
Iselin, N.J. 08830 

I hereby declare that all statements made herein on my own knowledge are true and that 
all statements made on information and belief are believed to be true, and further that these 
statements were made with the knowledge that willful false statements and the like so made 
are punishable by fine or imprisonment, or both, under Section 1001 of Title 18 of the State 
Code and that such willful false statements may jeopardize the validity of the application or 
any patent issuing thereon. 
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Full name of first 
joint inventor: 

Mark Bernard Hettish 



Inventor's signature: 




Date: ///o/t 



00 



Residence: Cary, NC 



Citizenship: (£, 

Q 

€1 Post Office Address: 



1 12 Kingussie Ct, Cary, NC, 2751 1 



